Std VarSet/fr

Std Jeu de variables

Emplacement du menu
Aucun
Ateliers
Tous
Raccourci par défaut
Aucun
Introduit dans la version
1.0
Voir aussi
Atelier Spreadsheet, Atelier DynamicData

Description

La commande Std Jeu de variables crée un jeu de variables. Un jeu de variables est composé de propriétés utilisables comme variables dans des expressions.

La fenêtre de dialogue Ajouter des propriétés

Utilisation

  1. Faites l'une des choses suivantes :
  2. La fenêtre de dialogue Ajouter une propriété s'ouvre.
  3. Entrez un Nom pour la propriété.
    • Le nom doit être unique pour le jeu de variables.
    • Seuls les caractères alphanumériques et les tirets bas (A à Z, a à z, 0 à 9 et _) sont autorisés.
    • Le premier caractère ne peut pas être un chiffre.
    • FreeCAD utilise la convention UpperCamelCase pour ses noms de propriétés, ce qui signifie que chaque mot commence par une lettre majuscule, et qu'il n'y a pas d'espace ou de soulignement. Lorsque l'éditeur de propriétés affiche un tel nom, des espaces sont insérés entre les mots, ce qui rend le nom plus facile à lire. Il est conseillé de suivre cette convention.
  4. Entrez un nom de Groupe pour la propriété ou sélectionnez un groupe dans la liste. Les noms de groupes ont les mêmes restrictions que les noms de propriétés.
  5. Sélectionnez le Type de la propriété dans la liste. Voir ci-dessous pour les types les plus courants.
  6. Entrez une Valeur pour la propriété. Cette saisie accepte les unités pour les propriétés qui ont des unités. Vous pouvez également définir une expression.
  7. Vous pouvez cocher la case Ajouter d'autres propriétés si vous souhaitez ajouter d'autres propriétés.
  8. Vous pouvez saisir une infobulle pour la propriété.
  9. Appuyez sur le bouton OK.
  10. Si la case Ajouter d'autres propriétés a été cochée, la fenêtre de dialogue s'ouvre à nouveau et une nouvelle propriété peut être ajoutée.
  11. Appuyez sur le bouton Annuler lorsque vous avez terminé.

Types de propriétés courantes

FreeCAD prend en charge de nombreux types de propriétés. Le tableau ci-dessous répertorie certains des types les plus courants. Voir Propriétés personnalisées des fonctions de Python pour plus d'informations.

Type de propriété Unité par défaut (le cas échéant) Remarque
App::PropertyAngle ° (ou deg)
App::PropertyBool true ou false, peut être utilisé dans des expressions conditionnelles
App::PropertyDistance mm
App::PropertyFloat Nombre décimal
App::PropertyInteger Nombre entier
App::PropertyLength mm Semblable à App::PropertyDistance mais ne peut pas être négatif
App::PropertyString Chaîne de caractères

Remarques

  • Les propriétés peuvent également être ajoutées aux jeux de variables existants dans l'éditeur d'expressions en cochant la case Afficher les variables.
  • Une propriété peut être supprimée d'un jeux de variables via le menu contextuel de l'éditeur de propriétés.
  • Un nom de groupe peut être modifié via le même menu.
  • La commande ne peut pas pour le moment définir la liste des éléments autorisés d'une propriété App::PropertyEnumeration. Cela peut être fait via le code en Python ou dans l'éditeur de propriétés. Les étapes de cette dernière option sont les suivantes
    1. Sélectionnez Afficher les propriétés cachées dans le menu contextuel de l'éditeur de propriétés.
    2. Développez le nœud de la propriété.
    3. Cliquez sur le champ Énumération.
    4. Cliquez sur le bouton ... qui apparaît.
    5. Entrez des valeurs dans la fenêtre de dialogue Liste qui s'ouvre.
    6. Appuyez sur le bouton OK.
  • Les jeux de variables peuvent également être édités à l'aide des commandes de l'atelier DynamicData. Les propriétés peuvent être renommées, regroupées, réécrites et leur info-bulle peut être mise à jour. Cet atelier externe peut être installé à partir du gestionnaire des extensions.

Script

import FreeCAD as App

doc = App.ActiveDocument

var_set = doc.addObject("App::VarSet", "VarSetName")
var_set.addProperty("App::PropertyInteger", "MyNumber")  # Property is added to the Base group.
var_set.MyNumber = 123
var_set.addProperty("App::PropertyString", "MyText", group="SomeGroup", doc="Some tooltip information")
var_set.MyText = "Abc"

doc.recompute()